home *** CD-ROM | disk | FTP | other *** search
/ Power Bytes: Money & Finance / PowerBytes Money and Finance CD-ROM 01 / PowerBytes Money and Finance CD-ROM 01.iso / Utilities / Icon Tools / Icon Maker / IconMaker Doc next >
Encoding:
Text File  |  1986-11-25  |  5.8 KB  |  137 lines  |  [TEXT/EDIT]
  1. IconMaker
  2.   By J.Doenias and S.Gillespie
  3.   
  4. IconMaker allows you to customize application Icons (they are actually
  5. ICN#'s).  This program is only useful for reconfiguring existing 
  6. applications -- no method for creating new icons and FREF's is provided.
  7.  
  8. An ICN# contains two parts:  the icon, and the icon mask.  The mask
  9. determines how the icon will look when it is selected (inverted), and
  10. also it also determines the 'body' of the icon:  when in the finder,
  11. a mouse click must occur on the Mask in order for the icon to be selected.
  12.  
  13. In particular, IconMaker is perfect for changing the icons of Rascal
  14. stand-alone applications.  To make an application in Rascal, you use
  15. MakeAppl to convert the .obj program to an application.  Once this is
  16. finished, IconMaker can personalize the application, by changing the 
  17. icons and Creator Type.
  18. >>
  19.  
  20. You can work on icons any time while IconMaker is running, however in
  21. order to save an icon, copy your icon to the Clipboard, then Open...
  22. an Application file (once the application is opened, you can then
  23. paste your icon onto one of the existing application icons).
  24.  
  25. When you Open an application, a new menu will appear to the right of
  26. the icon menu (the menu will have the same name as the application).
  27. This menu will contain as many items as there are icons in the application
  28. file (for Rascal Applications, there should be two:  128 and 129).
  29.  
  30. Using the Mouse, Edit Menu, and the application Menu, edit the icons
  31. to your satisfaction.  
  32.  
  33. For Rascal Applications, Icon #128 is the application Icon (the one 
  34. which will appear on the Finder desktop), andIcon #129 is the text 
  35. file icon (using a menu command described below, you can change this
  36. from a TEXT icon, to some other type). 
  37. >>
  38.  
  39.  
  40. The IconMaker Edit Menu
  41.  
  42.   Undo, Cut, Copy and Paste 
  43.       These work pretty much as you would expect them too, except for 
  44.       the fact that IconMaker uses a private Clipboard -- when you 
  45.       quit the program, your icon will *not* be left on the Macintosh
  46.       clipboard.
  47.       
  48.   Icon --> Mask.  
  49.       This copies the Icon image to the Mask.  
  50. >>
  51.  
  52. The IconMaker Icon Menu
  53.  
  54.   New
  55.     This will cause any open application file to be closed, and the
  56.     icon image to be cleared.
  57.     
  58.   Open...
  59.     The standard file dialog box will appear:  select an application
  60.     which contains icons, and it will be opened.  If there are no
  61.     icons in the application, the Open... will not be successful.
  62.     
  63.   Save...
  64.     If an application file is open, any changes you have made to
  65.     the icons will be saved.  Don't forget to save your changes!
  66. >>
  67. The next Icon menu command is provided primarily for Rascal users...
  68.   
  69.   Change Icon Type
  70.     RasAppl.Master contains two icons:  the application icon, and the
  71.     file icon (initially, the TEXT file icon).  If your Rascal 
  72.     application creates files, they can have the file icon on
  73.     the Finder desktop:
  74.     
  75.       -- The file Creator field should agree with the application
  76.          creator type (see below).
  77.       -- The file Type field should agree with the type of the
  78.          file icon.
  79.          
  80.     When you select 'Change Icon Type,' (an icon from an application
  81.     must currently be selected), a dialog box will appear showing you
  82.     the current type:  enter a new type and click in the OK button.
  83. >>
  84.     Let's say, for instance, that your application is a text editor
  85.     that creates standard TEXT files.  If the Creator type of your
  86.     application is 'MYED' and if the file type of the file icon
  87.     is TEXT (the default), then the following Rascal call (from the
  88.     __Uniform library) will create a new file which will have the 
  89.     application's file icon on the Finder desktop:
  90.     
  91.       FCreate("NewFile"," MYED"+2," TEXT"+2,vref);
  92.       
  93.     Note: vref is the volume reference number of the disk that the
  94.           file will be created on.
  95.     
  96.     If your application, instead, creates files of type 'NERD', use
  97.     the Change Icon Type command to change the file icon to type
  98.     NERD, and use the following file creation call:
  99.     
  100.       FCreate("NewFile"," MYED"+2," NERD"+2,vref);
  101. >>
  102. The last item on the Icon menu is crucial:  you must use it in order
  103. to make your icons "stick" to the application.
  104.  
  105.   Enable New Icons
  106.     When you are completely satisfied with your icons, select this
  107.     item.  If the application is in order, a dialog box will appear.
  108.     This dialog box tells you what the current Creator field of the
  109.     application is.  The Creator field is a unique 4 character code 
  110.     which helps the Finder decide what icons to use on the desktop.
  111.     For Rascal Applications, this field will initially be RAPP.
  112.     
  113.     If you are configuring a Rascal application, and if the creator
  114.     does come up as RAPP, Type in a new Creator code (make one up...):  
  115.     this will be your new application's unique (we hope..) code.  
  116.     If your application already has a unique Creator field (e.g. if
  117.     you are just re-doing the icons), you don't need to change the Creator
  118.     Field.  Click in the OK button, and IconMaker will configure the 
  119.     Application. 
  120. >>
  121.     After doing 'Enable New Icons' just once, you can open and
  122.     close and re-edit the icons as much as you want.  However:  Once
  123.     you return to the Finder, the icons will 'stick' to the application
  124.     (because the Finder makes a copy of them).   
  125.     
  126.     If you do get back to the Finder and then decide to make more 
  127.     changes, you can go back into IconMaker and re-edit -- just make 
  128.     sure to do another 'Enable New Icons' before returning again 
  129.     to the Finder.
  130.     
  131. Note:  
  132.      When you Halt IconMaker (from Rascal's Run Menu), you may be asked
  133.      if you want to save changes before quitting:  Cancel is *not* an
  134.      option at this point, so either click in the Yes or No button.
  135.     
  136.      The Save Changes dialog box will function normally at all times
  137.      *other* than in response to a Halt command.